home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / sem_print.z / sem_print
Encoding:
Text File  |  2002-10-03  |  2.3 KB  |  66 lines

  1.  
  2.  
  3.  
  4. sssseeeemmmm____pppprrrriiiinnnntttt((((3333CCCC))))                                                    sssseeeemmmm____pppprrrriiiinnnntttt((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_mmmm______pppp_rrrr_iiii_nnnn_tttt - print the state of a POSIX semaphore
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_eeee_mmmm_aaaa_pppp_hhhh_oooo_rrrr_eeee_...._hhhh_>>>>
  13.      _iiii_nnnn_tttt _ssss_eeee_mmmm______pppp_rrrr_iiii_nnnn_tttt _((((_ssss_eeee_mmmm______tttt _****_s_e_m_,,,, _FFFF_IIII_LLLL_EEEE _****_f_d_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_l_a_b_e_l_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _ssss_eeee_mmmm______pppp_rrrr_iiii_nnnn_tttt obtains all the semaphore state of _s_e_m and writes it as a
  17.      formatted string to _f_d.  The string is prefixed with a user specified
  18.      _l_a_b_e_l.
  19.  
  20.      Semaphore types other than shared POSIX unnamed semaphores are not
  21.      supported by this function.
  22.  
  23.      _ssss_eeee_mmmm______pppp_rrrr_iiii_nnnn_tttt is an IRIX extension to the POSIX interfaces and is not part of
  24.      the IEEE 1003.1b Standard.
  25.  
  26.      _ssss_eeee_mmmm______pppp_rrrr_iiii_nnnn_tttt will fail if one or more of the following are true:
  27.  
  28.      [EINVAL]       The specified semaphore is not a supported semaphore type.
  29.  
  30.      [EBADF]        The specified file is invalid.
  31.  
  32. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  33.      Upon successful completion, a value of 0 is returned to the calling
  34.      process. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to
  35.      indicate the error.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.